home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
SPACE 2
/
SPACE - Library 2 - Volume 1.iso
/
apps
/
623
/
scrndraw
/
scrndraw.txt
< prev
Wrap
Text File
|
1992-09-06
|
30KB
|
1,066 lines
Page 1
SSSSS CCCCC RRRR EEEEE EEEEE N N DDDD RRRR AAA W W
S C R R E E NN N D D R R A A W W W
SSSSS C RRRR EEE EEE N N N ----- D D RRRR AAAAA W W W
S C R R E E N N N D D R R A A W W W
SSSSS CCCCC R RR EEEEE EEEEE N NN DDDD R RR A A WWW
Version 1.0
Copyright 1992 by Scott R. Garrigus
All Rights Reserved.
Scott R. Garrigus
c/o S.R.G. Software
130 Goodhue Road
Derry, NH 03038
GEnie: S.GARRIGUS
PAN: GARRIGUS
This software is provided as-is.
There are no warranties, expressed or implied.
S.R.G. SOFTWARE DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFT-
WARE, WHETHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
ANY IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
PARTICULAR PURPOSE, AND ALL SUCH WARRANTIES ARE EXPRESSLY AND
SPECIFICALLY DISCLAIMED. NEITHER S.R.G. SOFTWARE NOR ANYONE
ELSE WHO HAS BEEN INVOLVED IN THE CREATION, PRODUCTION, OR
DELIVERY OF THIS SOFTWARE SHALL BE LIABLE FOR ANY INDIRECT, CON-
SEQUENTIAL, OR INCIDENTAL DAMAGES ARISING OUT OF THE USE OR
INABILITY TO USE SUCH SOFTWARE EVEN IF S.R.G. SOFTWARE HAS BEEN
ADVISED OF THE POSSIBILITY OF SUCH DAMAGES OR CLAIMS. IN NO
EVENT SHALL S.R.G. SOFTWARE'S LIABILITY FOR ANY DAMAGES EVER
EXCEED THE PRICE PAID FOR THE LICENSE TO USE THE SOFTWARE,
REGARDLESS OF THE FORM OF CLAIM. THE PERSON USING THE SOFT-
WARE BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THE
SOFTWARE.
Page 2
Some states do not allow the exclusion of the limit of liability for
consequential or incidental damages, so the above limitation may not apply
to you.
This agreement shall be governed by the laws of the State of New
Hampshire and shall inure to the benefit of S.R.G. Software and any
successors, administrators, heirs and assigns. Any action or proceeding
brought by either party against the other arising out of or related to
this agreement shall be brought only in a STATE or FEDERAL COURT of
competent jurisdiction located in Rockingham County, New Hampshire. The
parties hereby consent to in personam jurisdiction of said courts.
SHAREWARE
This program is Shareware. It may be distributed freely as long as it is
unaltered in any way and includes this documentation. If you find this
program useful please send a check or money order (drawn on a US bank) for
$15 made out to Scott R. Garrigus to:
Scott R. Garrigus
c/o S.R.G. Software
130 Goodhue Road
Derry, NH 03038
THANKYOU!
Page 3
Table Of Contents
-----------------
INTRODUCTION .................................... 5
GETTING STARTED ............................... 6
About this Manual ............................... 6
Loading Screen-Draw .......................... 7
THE BASICS .................................... 8
The Menu Screen ............................... 8
Keys and Keystrokes .......................... 9
Screens and Mouse Control ..................... 9
Colors ......................................... 10
Fill Patterns ............................... 10
Leaving Screen-Draw .......................... 10
THE DRAWING COMMANDS .......................... 11
Plot ......................................... 11
Line ......................................... 11
Box ......................................... 12
PBox ......................................... 12
RBox ......................................... 13
PRBox ......................................... 13
Circle ......................................... 14
PCircle ......................................... 14
Ellipse ......................................... 15
PEllipse .................................... 15
Fill ......................................... 16
Text ......................................... 16
Erase Object .................................... 17
THE MENU BAR .................................... 17
File ......................................... 17
Load ......................................... 17
Save ......................................... 18
Save As .LST ............................... 18
Quit ......................................... 18
Line ......................................... 19
Text ......................................... 19
GMode ......................................... 19
Options ......................................... 20
Page 4
This page left blank intentionaly.
INTRODUCTION Page 5
Screen-Draw is a drawing utility for programmers using GFA-Basic. With it
you can draw pictures on the screen using the mouse and then later have
your picture converted into the GFA-Basic graphics commands such as PLOT,
LINE, etc. and save them in the .LST file format for inclusion into your
own programs. Screen-Draw currently supports the ST and STE and works in
all three resolution modes. Screen-Draw works with one or two floppy disk
drives, RAMdisks and hard disk drives.
Before you use Screen-Draw, you should read your ST/STE manual to learn
how to use menus, load programs, make copies, and use all of the other
basic features of the machine.
In order for you to be able to easily find the information you need, I
have included a Table of Contents and an Index in this manual. In order
to find the exact page you need just set your file viewer to find Page xx,
xx being the page number. This should take you to the top of the page you
need to find.
GETTING STARTED Page 6
About This Manual
While every attempt has been made to provide you with a complete manual,
things often change at the last minute. If you happen to find a file on
the master disk called README.1ST, please do exactly that. Read or print
out this file before you start reading any more of this manual.
This manual is organized in such a manner as to let you get started as
soon as possible. The first few chapters introduce you to Screen-Draw and
it's basic features. From there the manual is basically a reference,
though you should read it to gain a full understanding of all of Screen-
Draw's features. Both a Table of Contents and an Index have been provided
to help you find exactly what you need to know as fast as possible.
Loading Screen-Draw Page 7
The only file needed to run Screen-Draw is the actual program file itself.
There are no resource files or support files. All you need do is double-
click on SCRNDRAW.PRG and Screen-Draw will run. Screen-Draw is designed
to work in all three screen resolutions so it doesn't matter which one you
start it from. Though if you want to work in a resolution other than the
one you're in, you'll have to set that resolution before running Screen-
Draw.
Hard disk users can run Screen-Draw from any drive or within a folder on
any drive, and save to any drive or folder.
THE BASICS Page 8
The Menu Screen
Looking at the menu screen you'll see four main sections. First is the
menu bar across the top of the screen. This holds the selections '',
'File', 'Line', 'Text', 'GMode', and 'Options'. Below that is the color
palette which displays the available colors in the current resolution --
16 in Low Res., 4 in Medium Res., and 2 in High Res. Next to that is the
Setcolor button which calls up the setcolor dialog to allow you to change
the colors of the available color registers. Below this are the last two
sections. On the left are the drawing command buttons and on the right
are the fill selection buttons.
By moving the mouse cursor onto one of the available buttons (color
button, setcolor button, command button, or fill button) and pressing the
left mouse button, that screen button will be highlighted, indicating that
you've selected that feature. The setcolor button is the only unique
button in that it will call up the setcolor dialog and allow you to change
the current color pallete.
Whatever color button you select, that is the color you will draw with.
Whatever fill button you select, that is the pattern that objects will be
filled with. There are many other features which effect the outcome of
your drawing and those are available from the drop down menus.
Keys and Keystrokes Page 9
Almost all of Screen-Draws functions have keyboard equivalents. Color
selections are cycled by the use of the up and down arrows. Fill
selections are cycled by the use of the left and right arrows. Drawing
commands have keys with the first letter of their name assigned to them.
For example the key equivalent for Plot is P. There are commands which
are related to other commands such as Circle and PCircle. These related
commands can be set by pressing the ALT key and the first letter of the
related command. For example, the key equivalent for PCircle is ALT-C.
Finally, there are three other very important keys which are not assigned
in the above manner. The key equivalent for Erase Object is the Delete
key. If you would like to clear the workscreen then you would press the
Clr Home key. You can only do this from the drawing screen. And last bu
not least is the UNDO key. This key also can only be used on the drawing
screen. It will undo whatever you're last action was and it can also be
used to undo an undo. Be sure, however, to undo your mistake before you
go about doing anymore drawing or undo will not work. Though you can just
erase your mistake with the Erase Object command, so all is not lost.
Screens and Mouse Control
When you first run Screen-Draw you will find yourself on the menu screen.
This screen is where you choose which drawing command to use, which color
you'd like to draw with, etc. There are also many options available from
the menu bar which will effect certain aspects of your drawing. For
example, in the Line menu you can choose what type of line, the size of
line, and the type of line ends which you want to appear when you go about
drawing lines. The same type of options are available for text under the
Text menu.
Now, to do some drawing, you must first go to the drawing screen. To do
this, just press the right mouse button. The sole purpose of the right
mouse button is to switch between the menu screen and the drawing screen
as long as your not in the middle of drawing something such as a line. If
you do happen to be in the middle of a command, your first right mouse
button click will let go of that command and then another right click will
switch screens for you. All drawing commands are affected this way except
for Plot and Fill.
Colors Page 10
Colors can be selected either by left clicking on them with the mouse on
the menu screen or by using the up and down arrow keys to cycle through
them. Only the colors available to the current resolution will appear on
the screen. To change the avaiable colors you must left click on the
Setcolor button. Doing this in low or medium resolution will bring up the
setcolor dialog box but in high resolution the screen colors are just
flipped since only two (Black and White) are available.
In the setcolor dialog you will find the mini color palette, from which
colors can be selected with a left mouse button click. Under this, on the
left, you will find the RGB numbers which make up the currently selected
color. To change these numbers just left click on either the + or -
buttons above whichever number you wish to change. If you'd like all the
colors restored to the ST/STE default color palette then click on the
Default button and select yes in the following alert box. When your
finished changing colors, you can either keep your changes by left
clicking on the Okay button or you can ignore any color changes you made
by left clicking on the Cancel button. After you select either one of
these buttons the setcolor dialog will disappear and your changes will be
registered.
Fill Patterns
Fill patterns are displayed on the right hand side of the menu screen and
can be selected by either left clicking on a pattern with the mouse or by
cycling through the patterns using the left and right arrow keys. You
can change fill patterns while on the drawing screen by using the left and
right arrow keys.
Only the ST/STE system fill patterns are available in this version of
Screen-Draw, but this will change in the next version.
Leaving Screen-Draw
To exit Screen-Draw, all you need to do is select Quit in the File menu on
the menu screen. If you haven't saved your work, the program will ask you
if you'd like to, before exiting. If you have saved your work, then
Screen-Draw will just exit, no questions asked.
THE DRAWING COMMANDS Page 11
Plot
Keypress: P
The Plot command is used to draw individual points or freehand lines. To
draw a point, press the left mouse button once and then release it. A
point will be drawn in the currently selected color at the current mouse
position. To draw freehand, press and hold down the left mouse button and
move the mouse around to draw. Let go of the button when your done
drawing.
The only parameter which effects Plot is Color. To select a color, just
left click your choice on the menu screen or use the up and down arrow
keys on either screen.
The last point or freehand line drawn can be undone by pressing the UNDO
key while on the drawing screen or by using the Erase Object command.
Line
Keypress: L
The Line command is used to draw lines on the screen. To draw a line,
position the mouse cursor on the screen where you'd like the line to start
and click the left mouse button once. Then move the mouse around the
screen to the place you'd like the line to end and press the left mouse
button once more. Your line will then be drawn. If you are in the middle
of drawing a line and decide not to, or you'd like to choose a new start
point, then click the right mouse button once and start over again.
The following parameters affect the appearance of a line and are each
described in their own sections of the manual:
Graphmode - page 19
Linestyle - page 19
Line Thickness - page 19
Line Ends - page 19
There is also, of course, Color, which has already been explained above.
The last line drawn can be undone by pressing the UNDO key while on the
drawing screen or by using the Erase Object command.
Box Page 12
Keypress: B
The Box command is used to draw a square or rectangular outline. Position
the mouse cursor where you'd like the first corner of the box to appear
and press the left mouse button once. Then move the mouse until the box
shape you want is shown and press the left mouse button once more. To let
go of a box while drawing, just press the right mouse button once and you
can start over again.
The Box command is affected by the following parameters:
Color - page 10
Graphmode - page 19
Line Style - page 19
Line Thickness - page 19
The last box drawn can be deleted by pressing UNDO while on the drawing
screen or by using the Erase Object command.
PBox
Keypress: ALT-B
The PBox command is used to draw a filled square or rectangle. Position
the mouse cursor where you'd like the first corner of the box to appear
and press the left mouse button once. Then move the mouse until the box
shape you want is shown and press the left mouse button once more. To let
go of a box while drawing, just press the right mouse button once and you
can start over again.
The filled box can also be drawn with an outline by turning the Bndry item
in the Options menu on. See page 20 for more details.
The PBox command is affected by the following parameters:
Color - page 10
Graphmode - page 19
Fill Pattern - page 10
Boundary - page 20
The last box drawn can be deleted by pressing UNDO while on the drawing
screen or by using the Erase Object command.
RBox Page 13
Keypress: R
The RBox command is used to draw a square or rectangular outline with
rounded corners. Position the mouse cursor where you'd like the first
corner of the box to appear and press the left mouse button once. Then
move the mouse until the box shape you want is shown and press the left
mouse button once more. To let go of a box while drawing, just press the
right mouse button once and you can start over again.
The RBox command is affected by the following parameters:
Color - page 10
Graphmode - page 19
Line Style - page 19
Line Thickness - page 19
The last box drawn can be deleted by pressing UNDO while on the drawing
screen or by using the Erase Object command.
PRBox
Keypress: ALT-R
The PRBox command is used to draw a filled square or rectangle with
rounded corners. Position the mouse cursor where you'd like the first
corner of the box to appear and press the left mouse button once. Then
move the mouse until the box shape you want is shown and press the left
mouse button once more. To let got of a box while drawing, just press the
right mouse button once and you can start over again.
The filled box can also be drawn with an outline by turning the Bndry item
in the Options menu on. See page 20 for more details.
The PRBox command is affected by the following parameters:
Color - page 10
Graphmode - page 19
Fill Pattern - page 10
Boundary - page 20
The last box drawn can be deleted by pressing UNDO while on the drawing
screen or by using the Erase Object command.
Circle Page 14
Keypress: C
The Circle command is used to draw a circular outline. Position the mouse
cursor where you'd like the center of the circle to appear and press the
left mouse button once. Then move the mouse until the circular shape you
want is shown and press the left mouse button once more. To let go of a
circle while drawing, just press the right mouse button once and you can
start over again.
The Circle command is affected by the following parameters:
Color - page 10
Graphmode - page 19
Line Style - page 19
Line Thickness - page 19
The last circle drawn can be deleted by pressing UNDO while on the drawing
screen or by using the Erase Object command.
PCircle
Keypress: ALT-C
The PCircle command is used to draw a filled circle. Position the mouse
cursor where you'd like the center of the circle to appear and press the
left mouse button once. Then move the mouse until the circular shape you
want is shown and press the left mouse button once more. To let go of a
circle while drawing, just press the right mouse button once and you can
start over again.
The filled circle can also be drawn with an outline by turing the Bndry
item in the Options menu on. See page 20 for more details.
The PCircle command is affected by the following parameters:
Color - page 10
Graphmode - page 19
Fill Pattern - page 10
Boundary - page 20
The last circle drawn can be deleted by pressing UNDO while on the drawing
screen or by using the Erase Object command.
Ellipse Page 15
Keypress: E
The Ellipse command is used to draw an elliptical outline. Position the
mouse cursor where you'd like the center of the ellipse to appear and
press the left mouse button once. Then move the mouse until the
elliptical shape you want is shown and press the left mouse button once
more. To let go of an ellipse while drawing, just press the right mouse
button once and you can start over again.
The Ellipse command is affected by the following parameters:
Color - page 10
Graphmode - page 19
Line Style - page 19
Line Thickness - page 19
The last ellipse drawn can be deleted by pressing UNDO while on the
drawing screen or by using the Erase Object command.
PEllipse
Keypress: ALT-E
The PEllipse command is used to draw a filled ellipse. Position the mouse
cursor where you'd like the center of the ellipse to appear and press the
left mouse button once. Then move the mouse until the elliptical shape
you want is shown and press the left mouse button once more. To let go of
an ellipse while drawing, just press the right mouse button once and you
can start over again.
The filled ellipse can also be drawn with an outline by turning the Bndry
item in the Options menu on. See page 20 for more details.
The PEllipse command is affected by the following parameters:
Color - page 10
Graphmode - page 19
Fill Pattern - page 10
Boundary - page 20
The last ellipse drawn can be deleted by pressing UNDO while on the
drawing screen of by using the Erase Object command.
Fill Page 16
Keypress: F
The Fill command is used to fill any enclosed area with the currently
selected fill pattern. Position the mouse cursor inside the area you want
filled and press the left mouse button once. The area will then be
filled.
A fill pattern can be selected by going to the menu screen and left
clicking on the desired fill pattern button or the left and right arrow
keys can be used to cycle through the available patterns.
The Fill command is affected by the following parameters:
Color - page 10
Graphmode - page 19
Fill Pattern - page 10
The last Fill done can be deleted by pressing UNDO while on the drawing
screen or by using the Erase Object command.
Text
Keypress: T
The Text command is used to draw upper- and lowercase letters, punctuation
and numbers. Position the mouse cursor where you'd like the text to
appear and then type your message on the keyboard. The BACKSPACE key
erases the last character and the ESC key erases the whole line of text,
allowing you to start over again. When your finished typing you can
reposition the text with the mouse if you'd like or just press the left
mouse button once to place the text on the screen.
Text attributes (type, direction, and size) can be changed by selecting
the appropriate items in the Text menu. See page XX for more details.
The Text command is affected by the following parameters:
Color - page 10
Graphmode - page 19
Text Style - page 19
Text Direction - page 19
Text Size - page 19
The last text line drawn can be deleted by pressing UNDO while on the
drawing screen or by using the Erase Object command.
Erase Object Page 17
Keypress: DELETE
The Erase Object command is used to delete objects from the screen and
from the main data array. When Erase Object is selected, Screen-Draw will
attach a small square to each object on the screen. To delete an object,
just position the mouse cursor over its attached square and press the left
mouse button once. Screen-Draw will then take a few seconds to delete the
object. In the case of free-hand plot lines Screen-Draw may take quite a
while deleting, so be aware of this when deleting such objects.
The last object erased can be brought back by pressing the UNDO key while
on the drawing screen.
The Menu Bar
File
Load
The Load menu item is used to load in a Screen-Draw file from disk.
Please refer to your ST/STE manual if you don't understand how to
accomplish this.
Screen-Draw files from different resolutions can also be loaded. An alert
box will ask you whether you'd like the picture converted to the current
resolution and you can answer either yes or no. Either way the picture
will be loaded. The conversion process only resizes the picture data.
Any text in the picture will remain at its original size but will be
positioned correctly.
Screen_Draw files have the following extentions:
.DR0 Low Resolution
.DR1 Medium Resolution
.DR2 High Resolution
Save Page 18
The Save menu item is used to save a Screen-Draw file to disk. Please
refer to you ST/STE manual if you don't understand how to accomplish this.
The current picture and color palette will be saved to disk with the
appropriate file extention according to resolution.
Screen-Draw files have the following extentions:
.DR0 Low Resolution
.DR1 Medium Resolution
.DR2 High Resolution
Save as .LST
The Save as .LST menu item is used to convert the current picture and
color palette into a GFA Basic .LST file. This file can then be merged
with your program code. This function is the very reason this program was
written.
The picture data can be saved as is or it can be saved as resolution
independent. This means that the data is saved with additional resizing
code so that it can be displayed in all resolutions. This does not include
text since it needs to be reformated to be converted. All other picture
data is resizeable though. You will be given this option before you save
the file.
Quit
The Quit menu item is used to exit Screen-Draw and return to the desktop.
If you haven't saved your picture data yet, you'll be asked if you'd like
to do so before exiting.
Line Page 19
The Line menu is used to set the line attributes. You can select the line
style, line size, and how you'd like line ends to appear. Just select the
attributes you'd like by left clicking with mouse. Some of these
attributes also affect commands other than Line.
Commands affected by line attributes are:
Line
Box
Circle
Ellipse
Text
The Text menu is used to set the text attributes. You can select the text
style, text direction, and text size. Text styles can be mixed, such as
underlined and italic at the same time. Just select the attributes you'd
like by left clicking with the mouse.
GMode
The GMode menu is used to set the Graphmode. This determines how your
command is written to the screen. You can find details in the GFA Basic
manual.
Options Page 20
Bndry
The Bndry menu item is used to turn the outline of filled objects on and
off. If on, then an outline will be drawn around filled objects such as
PBox, PRBox, PCircle, and PEllipse. If off, then an outline will not be
drawn.
Grid
The Grid menu item is used to turn the drawing screen grid on and off.
The menu items below that are used to determine the size of the grid. The
grid can also be turned on and off by using G on the keyboard and when the
grid is actie the size can be selected by using the 1,2,3, and 4 keys on
the keyboard.
The grid can be used to align objects on the drawing screen, which is very
useful when designing a control type screen for a program.
The grid sizes available are:
Size2 - a 2x2 grid.
Size4 - a 4x4 grid.
Size8 - an 8x8 grid.
Size 16 - a 16x16 grid.
This program was written using GFA Basic version 3.5E.
GFA Basic is Copyright 1988 by GFA Systemtechnik GmbH.